home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 47.7z / BS1 part 47 / ImageMaster RT v1.50b (1994)(Black Belt Systems)(Disk 4 of 7)[HD].7z / ImageMaster RT v1.50b (1994)(Black Belt Systems)(Disk 4 of 7)[HD].adf / apa.lzh.parta / hlp_arexx4 < prev    next >
Text File  |  1994-03-17  |  21KB  |  795 lines
  1. \ApAssist
  2. \: - This is the Quick Help for the ARexx in IM R/t -
  3. \: ----------------------------------------------------------
  4. \:   Written by David E. Patterson
  5. \: ----------------------------------------------------------
  6.  
  7. \font topaz.font 8
  8. \tc 1
  9. \wr
  10. \lj
  11. \dd "imh_descriptor"
  12.  
  13. \index "hlp_arexx2/absadd-askstring"
  14. \toc "imh_toc/toc"
  15. \help "aa_help/help
  16.  
  17. \node "absadd"
  18. \title "Absolute Add"
  19. \next "abssub"
  20. \prev ""
  21. \{ \tc 15 Absadd \} - Absolute add of secondary buffer to the primary buffer.
  22.  
  23. Adds the secondary to the primary and produces the absolute sum of both. If
  24. the primary buffer and secondary buffer are middle grays the result will be
  25. white.
  26.  
  27. \nw
  28. Usage - '\{ \tc 15 absadd\} '
  29.  
  30. \{ \ts bu Sample Script\} :
  31.  
  32. 'area';
  33. '\{ \tc 15 absadd\} ';
  34.  
  35. See also: \{ \nw \ts b \link "abssub" "abssub"
  36.           \link "add   " "add"\}
  37.  
  38.     * User Interface: \{ \tc 15 Compose Panel
  39.                          Algebraic Compositions
  40.                              Add Absolute\}
  41.  
  42. \endnode
  43.  
  44. \node "abssub"
  45. \title "Absolute Subtract"
  46. \next "actpri"
  47. \prev "absadd"
  48. \{ \tc 15 Abssub \} - Absolute subtract of secondary buffer from primary
  49. buffer. 
  50.  
  51. The Secondary Buffer is subtracted from the Primary Buffer. If an area of the
  52. Primary image is an intermediate gray and the corresponding Secondary Buffer
  53. area is intermediate gray the resulting image area will be black.
  54.  
  55. \nw
  56. Usage - '\{ \tc 15 abssub\} ' (No Parameters)
  57.  
  58. \{ \ts bu Sample Script\} :
  59.  
  60. 'area';
  61. '\{ \tc 15 abssub\} ';
  62.  
  63.  
  64. See also: \{ \ts b \link "absadd" "absadd"
  65.           \link "add   " "add"\}
  66.  
  67. * User Interface: \{ \tc 15 Compose Panel
  68.                     Algebraic Compositions
  69.                       Absolute Subtract\}
  70.  
  71. \endnode
  72.  
  73. \node "actpri"
  74. \title "Actual Primary"
  75. \next "add"
  76. \prev "abssub"
  77. \{ \tc 15 Actpri \}  -  Reports primary buffer number
  78.  
  79. Reports the preserved old primary buffer number during a multi-frame
  80. sequence.  In the \{ \ts i \ts b Multi-Frame Sequence \} panel use \{ \ts i
  81. \ts b Add Scripts\} , and add the script containing 'actpri' as a pre-
  82. render script.
  83.  
  84. \nw
  85. Usage - '\{ \tc 15 actpri\} ' (No Parameters)
  86.  
  87. \{ \ts bu Sample Script\} :
  88.  
  89. options results;
  90. \{ \tc 15 actpri\} ;
  91. prime = results;
  92. say "Old Primary is buffer number:" prime;
  93. options;
  94.  
  95. \endnode
  96.  
  97. \node "add"
  98. \title "Add"
  99. \next "addasb"
  100. \prev "actpri"
  101. \{ \tc 15 Add \} - Adds the secondary buffer and primary buffer together.
  102.  
  103. The secondary buffer image is added to the primary buffer.  The resulting
  104. image is an average of the two images.
  105.  
  106. \nw
  107. Usage - '\{ \tc 15 add\} '
  108.  
  109. \{ \ts bu Sample Script:\}
  110.  
  111. 'area';
  112. '\{ \tc 15 add\} ';
  113.  
  114. See also: \{ \ts b \link "absadd" "absadd"
  115.           \link "abssub" "abssub"\}
  116.  
  117. * User Interface: \{ \tc 15 Compose Panel
  118.                       Algebraic Compositions
  119.                           Add\}
  120. \endnode
  121.  
  122. \node "addasb"
  123. \title "Add As Blue"
  124. \next "addasc"
  125. \prev "add"
  126. \{ \tc 15 Addasb \} - \{ \tc 15 Blue \} element of secondary buffer is added
  127. to primary buffer.
  128.  
  129. Adds the \{ \tc 15 blue \} element of the secondary buffer image to the
  130. primary buffer.  If the red, green, and blue are added one at a time to a
  131. black buffer the secondary buffer is recreated in the primary buffer.
  132.  
  133. \nw
  134. Usage - '\{ \tc 15 addasb\} '
  135.  
  136. \{ \ts bu Sample Script\} :
  137.  
  138. 'area';
  139. '\{ \tc 15 addasb\} ';
  140.  
  141. See also: \{ \ts b \link "addasc" "addasc"
  142.           \link "addasg" "addasg"
  143.           \link "addask" "addask"
  144.           \link "addasm" "addasm"
  145.           \link "addasr" "addasr"
  146.           \link "addasy" "addasy"\}
  147.           
  148. * User Interface: \{ \tc 15 Compose Panel
  149.                       Color Re-Combinations
  150.                           Add as Blue\}
  151.  
  152. \endnode
  153.  
  154. \node "addasc"
  155. \title "Add As Cyan"
  156. \next "addasg"
  157. \prev "addasb"
  158. \{ \tc 15 Addasc \}  - The \{ \tc 12 Cyan \} element of the secondary buffer
  159. is added to the primary buffer.
  160.  
  161. Adds the \{ \tc 12 Cyan \} element of the secondary buffer image to the
  162. primary buffer.  When cyan, magenta, yellow and black (from a CMYK Color
  163. Separation) are added one at a time to a white buffer, the full color image 
  164. is recreated in the Primary Buffer.  Note RGB are additive, while CMYK are
  165. subtractive. 
  166.  
  167. \nw
  168. Usage - '\{ \tc 15 addasc\} ' 
  169.  
  170. \{ \ts bu Sample Script\} :
  171.  
  172. 'area';
  173. '\{ \tc 15 addasc\} ';
  174.  
  175. See also: \{ \ts b \link "addasb" "addasb"
  176.           \link "addasg" "addasg"
  177.           \link "addask" "addask"
  178.           \link "addasm" "addasm"
  179.           \link "addasr" "addasr"
  180.           \link "addasy" "addasy"\}
  181.  
  182. * User Interface: \{ \tc 15 Compose Panel
  183.                           Color Re-Combinations
  184.                               Add as Cyan\}
  185.  
  186. \endnode
  187.  
  188. \node "addasg"
  189. \title "Add As Green"
  190. \next "addask"
  191. \prev "addasc"
  192. \{ \tc 15 Addasg \} - \{ \tc 10 Green \} element of the secondary buffer is
  193. added to the primary buffer.
  194.  
  195. Adds the \{ \tc 10 Green \} element of the secondary buffer image to the
  196. primary buffer.  If the red, green, and blue components of the secondary
  197. buffer were added to a black primary buffer, the secondary buffer would be
  198. recreated in the primary buffer.
  199.  
  200. \nw
  201. Usage - '\{ \tc 15 addasg\} '
  202.  
  203. \{ \ts bu Sample Script\} :
  204.  
  205. 'area';
  206. '\{ \tc 15 addasg\} ';
  207.  
  208. See also: \{ \ts b \link "addasb" "addasb" 
  209.           \link "addasc" "addasc"
  210.           \link "addask" "addask"
  211.           \link "addasm" "addasm" 
  212.           \link "addasr" "addasr"
  213.           \link "addasy" "addasy"\}
  214.              
  215. * User Interface: \{ \tc 15 Compose Panel 
  216.                      Color Re-Combinations
  217.                           Add as Green\}  
  218.  
  219. \endnode
  220.  
  221. \node "addask"
  222. \title "Add As Black"
  223. \next "addasm"
  224. \prev "addasg"
  225. \{ \tc 15 Addask \} - Black element of the secondary buffer is added to the
  226. primary buffer. 
  227.  
  228. Adds the Black element of the secondary buffer image to the primary buffer.
  229. If Cyan, Magenta, Yellow, and black (from a CMYK Color Separation) are added
  230. to an all white primary buffer, the full color image is recreated in the
  231. primary.
  232.  
  233. \nw
  234. Usage - '\{ \tc 15 addask\} ' 
  235.   
  236. \{ \ts bu Sample Script\} :
  237.      
  238. 'area';
  239. '\{ \tc 15 addask\} ';
  240.         
  241. See also: \{ \ts b \link "addasb" "addasb"
  242.           \link "addasc" "addasc"
  243.           \link "addasg" "addasg"
  244.           \link "addasm" "addasm"
  245.           \link "addasr" "addasr"
  246.           \link "addasy" "addasy"\}
  247.          
  248. * User Interface: \{ \tc 15 Compose Panel 
  249.                         Color Re-Combinations
  250.                           Add as Black\}
  251.                               
  252. \endnode
  253.  
  254. \node "addasm"
  255. \title "Add As Magenta"
  256. \next "addasr"
  257. \prev "addask"
  258. \{ \tc 15 Addasm \} - \{ \tc magenta Magenta \} element of the secondary
  259. buffer is added to the primary buffer. 
  260.  
  261. Adds the \{ \tc magenta Magenta \} element of the Secondary Buffer image to
  262. the primary buffer.  When Cyan, Magenta, Yellow and blacK (from a CMYK Color
  263. Separation) are added one at a time to a white buffer, the full color image
  264. is recreated in the primary buffer.  Note RGB are additive, while CMYK are subtractive.
  265.     
  266. \nw
  267. Usage - 'addasm'  
  268.    
  269. \{ \ts bu Sample Script\} :
  270.         
  271. 'area';
  272. '\{ \tc 15 addasm\} ';
  273.        
  274. See also: \{ \ts b \link "addasb" "addasb"          
  275.           \link "addasc" "addasc"
  276.           \link "addasg" "addasg"
  277.           \link "addask" "addask"
  278.           \link "addasr" "addasr"
  279.           \link "addasy" "addasy"\}
  280.                     
  281.              
  282. * User Interface: \{ \tc 15 Compose Panel 
  283.                       Color Re-Combinations
  284.                           Add as Magenta\}
  285.  
  286. \endnode
  287.  
  288. \node "addasr"
  289. \title "Add As Red"
  290. \next "addasy"
  291. \prev "addasm"
  292. \{ \tc 15 Addasr \} - \{ \tc 9 Red \} element of the secondary buffer is
  293. added to the primary buffer. 
  294.  
  295. Adds the \{ \tc 9 Red \} element of the secondary buffer image to the primary
  296. buffer. If the red, green, and blue components of the secondary buffer are
  297. added to an all black primary buffer, the secondary buffer is recreated in
  298. the primary buffer.
  299.     
  300. \nw
  301. Usage - '\{ \tc 15 addasr\} '  
  302.     
  303. \{ \ts bu Sample Script\} :
  304.         
  305. 'area';
  306. '\{ \tc 15 addasr\} ';
  307.          
  308. See also: \{ \nw \ts b \link "addasb" "addasb"
  309.           \link "addasc" "addasc"
  310.           \link "addasg" "addasg"  
  311.           \link "addask" "addask"
  312.           \link "addasm" "addasm"
  313.           \link "addasy" "addasy"\}
  314.                       
  315. * User Interface: \{ \tc 15 Compose Panel 
  316.                     Color Re-Combinations
  317.                         Add as Red\}
  318.  
  319. \endnode
  320.  
  321. \node "addasy"
  322. \title "Add AS Yellow"
  323. \next "allowcancel"
  324. \prev "addasr"
  325. \{ \tc 15 Addasy \} - \{ \tc yellow Yellow \} element of the secondary buffer
  326. is added to the primary buffer.
  327.  
  328. Adds the \{ \tc yellow Yellow \} element of the secondary buffer image to the
  329. primary buffer.  If the cyan, magenta, yellow and black components (from a
  330. CMYK Color Separation) are added to an all white primary buffer, the full
  331. color image is recreated in the primary.  
  332.     
  333. \nw
  334. Usage - '\{ \tc 15 addasy\} ' 
  335.     
  336. \{ \ts bu Sample Script\} :
  337.         
  338. 'area';
  339. '\{ \tc 15 addasy\} ';
  340.       
  341. See also: \{ \ts b \link "addasb" "addasb"
  342.           \link "addasc" "addasc"
  343.           \link "addasg" "addasg"           
  344.           \link "addask" "addask"
  345.           \link "addasm" "addasm"
  346.           \link "addasr" "addasr"\}
  347.              
  348. * User Interface: \{ \tc 15 Compose Panel 
  349.                       Color Re-Combinations
  350.                           Add as Yellow\}
  351.  
  352. \endnode
  353.  
  354. \node "allowcancel"
  355. \title "Allow Cancel"
  356. \next "amigarender"
  357. \prev "addasy"
  358. \{ \tc 15 Allowcancel \} - Controls the use of the \{ \ts i \ts b Cancel \}
  359. gadget.
  360.     
  361. This Arexx command will enable or disable the cancel gadget.  
  362.         
  363. \nw
  364. Usage - '\{ \tc 15 allowcancel yes\} '
  365.         '\{ \tc 15 allowcancel no\} '
  366.             
  367. \{ \ts bu Sample Script\} :
  368.     
  369. if(flag = 0) then;
  370.   do
  371.   '\{ \tc 15 allowcancel no\} ';
  372.    end;
  373.      
  374. See also: \{ \ts b \link "cancel" "hlp_arexx5/cancel"\}
  375.  
  376. \endnode
  377.  
  378. \node "amigarender"
  379. \title "Amiga Render"
  380. \next "anti"
  381. \prev "allowcancel"
  382. \{ \tc 15 Amigarender \} - Creates viewable Amiga image files.
  383.  
  384. Renders to Amiga modes, based upon the nine possible parameters.
  385.  
  386. \nw    
  387. Usage - '\{ \tc 15 amigarender [PARAM:value]\} '
  388.     
  389. \{ \ts bu Sample Script\} :
  390.     
  391. 'renderpath ram:'
  392. 'renderext .iff'
  393. 'entire'
  394. '\{ \tc 15 amigarender RES:hi MOD:reg PLANES:4 D:12 NAME:myimage\} '
  395. 'finish'
  396.     
  397. \{ \ce \{ \ts bu Parameters\} :\} 
  398. \nw
  399.     
  400.     RES:xxx          LO,HI,SUPER                 Display resolution 
  401.     PLANES:n         1 through 8                 Image Bit depth
  402.     DEPTH:n          12 or 24                    Palette depth
  403.     MODE:xxx         REG,HALFBRITE (or HB),HAM   Display mode
  404.     LACE:xxx         YES or NO                   Display interlace
  405.     WIDTH:nnnn                                   Render output width
  406.     HEIGHT:nnnn                                  Render output height
  407.     USEPALETTE:xxx   YES or NO                   Use existing palette
  408.     COLORS:nn        2 to 256                    # of Colors to render
  409.     NAME:ttttttt                                 Output name 
  410.                                             
  411. If a parameter is omitted, in each case, the last setting is used, except
  412. COLORS which is set to the \{ \ts i normal \} value for this mode and bit
  413. depth.
  414.    
  415. Parameter names for 'AmigaRender' may be abbreviated to one character. 
  416. ON,OFF or (1,0) values may replace YES,NO.
  417.  
  418. \endnode
  419.  
  420. \node "anti"
  421. \title "Anti Alias"
  422. \next "antique"
  423. \prev "amigarender"
  424. \{ \tc 15 Anti \} - Smooths color changes.
  425.  
  426. This Arexx command will transforms sharp color changes to smooth color
  427. changes.
  428.     
  429. \nw
  430. Usage - '\{ \tc 15 anti\} ' 
  431.     
  432. \{ \ts bu Sample Script\} :
  433.     
  434. 'area';
  435. '\{ \tc 15 anti\} ';
  436.     
  437. See also: \{ \ts b \link "sharp" "hlp_arexx11/sharp"\}
  438.             
  439. * User Interface: \{ \tc 15  Process Panel
  440.                       Filters
  441.                            Anti - Alias\}
  442.  
  443. \endnode
  444.  
  445. \node "antique"
  446. \title "Antique"
  447. \next "area"
  448. \prev "anti"
  449. \{ \tc 15 Antique \} - Tints selected area yellow.
  450.  
  451. Gives the selected region an antique (yellowish) tint.
  452.     
  453. \nw    
  454. Usage - '\{ \tc 15 antique\} '   
  455.     
  456. \{ \ts bu Sample Script\} :
  457.     
  458. 'area';
  459. '\{ \tc 15 antique\} ';
  460.    
  461. See also: \{ \ts b \link "unantique" "hlp_arexx11/unantique"\}
  462.     
  463. * User Interface: \{ \tc 15  Process Panel
  464.                         Filters
  465.                            Antique\}
  466.  
  467. \endnode
  468.  
  469. \node "area"
  470. \title "Area"
  471. \next "areafill"
  472. \prev "antique"
  473. \{ \tc 15 Area \} - Calls area control panel.
  474.  
  475. Allows the user to choose a method of region selection, by presenting the
  476. user with an Area Control panel.  Processes following area selection will be
  477. performed within the selected area until a new area is selected.
  478.     
  479. \nw    
  480. Usage - '\{ \tc 15 area\} '  
  481.     
  482. \{ \ts bu Sample Script\} :
  483.     
  484. '\{ \tc 15 area\} ';
  485. 'add';
  486.     
  487. See also: \{ \ts b \link "entire  " "hlp_arexx7/entire"
  488.           \link "oval    " "hlp_arexx9/oval"        
  489.           \link "rect    " "hlp_arexx10/rect"
  490.           \link "rectarea" "hlp_arexx10/rect"\}
  491.     
  492. \endnode
  493.  
  494. \node "areafill"
  495. \title "Area Fill"
  496. \next "arstate"
  497. \prev "area"
  498. \{ \tc 15 Areafill \} - The areafill command is used to fill regions based on
  499. an area fill mode.  The mode can be selected using the fillmode command, or
  500. can be set in the \{ \ts b Fill Mode \} option in the \{ \ts b Paint \}
  501. panel.  The areafill command will fill the selected area with the current
  502. fill mode when it is called.
  503.  
  504. \nw    
  505. Usage - '\{ \tc 15 areafill\} '
  506.  
  507. \{ \ts bu Sample Script\} : 
  508. /* arexx areafill Example */
  509. address('IM_Port');
  510. 'fillmode angle'; 
  511. 'rangle 45';
  512. 'area';
  513. '\{ \tc 15 areafill\} ';
  514. 'finish';
  515.  
  516. * User Interface: \{ \tc 15  Paint Panel
  517.                        Area Fill\}
  518.  
  519. \endnode
  520.  
  521. \node "arstate"
  522. \title "Auto Redraw State"
  523. \next "askboolean"
  524. \prev "areafill"
  525. \{ \tc 15 Arstate \} - Checks the state of the Auto Redraw control.  If the
  526. control is on, then it returns an on state value.  This will then auto redraw
  527. the buffer.  If the control is off, then it returns an off state value.  This
  528. will not allow an auto redraw of the buffer.
  529.  
  530. \nw    
  531. Usage - '\{ \tc 15 arstate\} '
  532.     
  533. \{ \ts bu Sample Script\} : 
  534.     
  535. options results;
  536. '\{ \tc 15 arstate\} ' ;
  537. oldstate = result;
  538. options;
  539.  
  540. Later in the script when you would like to return the state of the auto
  541. redraw...
  542.  
  543. 'autoredraw '||oldstate;
  544.  
  545. * User Interface: \{ \tc 15  Display Panel
  546.                        Auto Redraw\}
  547.  
  548. \endnode
  549.  
  550. \node "askboolean"
  551. \title "Ask Boolean"
  552. \next "askfloat"
  553. \prev "arstate"
  554. \{ \tc 15 Askboolean \} - Presents boolean requester to user. 
  555.  
  556. Provides the user with a three button panel with one button preset.  It
  557. returns either a \{ \ts b 0 (No) \} or a \{ \ts b 1 (Yes) \}  state. The user
  558. can select one and then the other but the routine will not return the final
  559. selection until the user presses the done gadget.
  560.     
  561. \nw    
  562. Usage - '\{ \tc 15 askboolean <yestext> <notext> <preset>\} '
  563.     
  564. \{ \ts bu Sample Script\} :
  565.     
  566. options results;
  567. '\{ \ts 15 askboolean Yes No 0\} ';
  568. flag = result;
  569. options;
  570.   
  571. See also: \{ \ts b \link "asknumber" "asknumber"    
  572.           \link "askprop  " "askprop" 
  573.           \link "askrgb   " "askrgb"   
  574.           \link "askyn    " "askyn"
  575.           \link "askstring" "askstring"\}
  576.  
  577. \endnode
  578.  
  579. \node "askfloat"
  580. \title "Askfloat"
  581. \next "asknumber"
  582. \prev "askboolean"
  583. \{ \tc 15 Askfloat \} - Presents the user with a floating point slide gadget.
  584.  
  585. Presents the user with a floating point, or decimal number, slide gadget.
  586. The slide gadget can be set to have decimal value divisions.  For example,
  587. the slide gadget could be set to have a division for every tenth between the
  588. maximum and minimum values.
  589.  
  590. \{ \ra \image "imdoc:Clips/bomb.pic" l 10 \cap
  591. Warning: A slide gadget can only have 65,000 divisions.  This means that you
  592. could not specify a .00001 division setting between a minimum of 1 and a
  593. maximum of 20.\} 
  594.     
  595. \nw    
  596. Usage - '\{ \tc 15 askfloat <text> <initial value> <min value> <max value>
  597.         <interval>\} '
  598. \wr
  599.  
  600. \{ \ts b text\} : The text should contain the name of the setting.  As an
  601. example, the script below specifies the setting as the radius for a gaussian
  602. blur.  The text should always be quoted using a double quote.
  603.  
  604. \{ \ts b initial value\} : The initial value is the default setting of the
  605. gadget when it is presented to the user.
  606.  
  607. \{ \ts b min value\} : The minimum value is the lowest possible value for the
  608. variable that you are specifying.  The script below sets the minimum value to
  609. 1.0 . 
  610.  
  611. \{ \ts b max value\} : The maximum value is the highest possible value for
  612. the variable that you are specifying.  The script below sets the maximum
  613. value to 20.0 .
  614.  
  615. \{ \ts b interval\} : The interval is the specified divisions for the slide
  616. gadget.  This sets the actual interval between numbers.  The script below
  617. specifies an interval for every tenth.
  618.     
  619. \{ \ts bu Sample Script\} :
  620. 'area';
  621. options results;
  622. '\{ \tc 15 askfloat "Radius:" 3.5 1.0 20.0 .1\} '; 
  623. radius = result;
  624. options;
  625. 'gaussian ' radius;    
  626.  
  627.   
  628. See also: \{ \nw \ts b \link "askboolean" "askboolean
  629.           \link "asknumber " "asknumber"    
  630.           \link " askprop  " "askprop" 
  631.           \link " askrgb   " "askrgb"   
  632.           \link "  askyn   " "askyn"
  633.           \link "askstring " "askstring"\}
  634.  
  635.  
  636. \endnode
  637.  
  638. \node "asknumber"
  639. \title "Ask Number"
  640. \next "askprop"
  641. \prev "askfloat"
  642. \{ \tc 15 Asknumber \}  - Allows user to change a value in a text gadget.
  643.  
  644. This enables the user to edit or change a preset value in a text gadget.
  645.  
  646. \nw    
  647. Usage - '\{ \tc 15 asknumber <prompt> <numeric_preset>\} '
  648.  
  649. \{ \ts bu Sample Script\} :
  650.  
  651. options results;
  652. '\{ \ts 15 asknumber Value: 127\} '; 
  653. value = result;
  654. options;
  655.   
  656. See also: \{ \ts b \link "askprop   " "askprop"   
  657.           \link "askstring " "askstring"    
  658.           \link "askboolean" "askboolean"   
  659.           \link "askyn     " "askyn"
  660.           \link "askrgb    " "askrgb"\}
  661.  
  662. \endnode
  663.  
  664. \node "askprop"
  665. \title "Ask Prop"
  666. \next "askrgb"
  667. \prev "asknumber"
  668. \{ \tc 15 Askprop \} - Slider Prop for the selection of a numeric value.
  669.  
  670. Presents the user with a \{ \ts i slider \} for the selection of a numeric
  671. value.  The prop gadget is set to a preset value and the changed result is
  672. returned.
  673.  
  674. \nw    
  675. Usage - '\{ \tc 15 askprop <prompt> <numeric preset> <min> <max>\} '
  676.  
  677. \{ \ts bu Sample Script\} : 
  678.     
  679. options results;
  680. '\{ \tc 15 askprop "Red:" 50 0 255\} ';
  681. intensity = result;
  682. options;
  683.     
  684. See also: \{ \ts b \link "askboolean" "askboolean"
  685.           \link "asknumber " "asknumber"    
  686.           \link "askrgb    " "askrgb"    
  687.           \link "askstring " "askstring"
  688.           \link "askyn     " "askyn"\}
  689.           
  690. \endnode
  691.  
  692. \node "askrgb"
  693. \title "Ask Red Green Blue"
  694. \next "askstring"
  695. \prev "askprop"
  696. \{ \tc 15 Askrgb \} - Ask red green blue.
  697.  
  698. Presents a prop that allows the user to set RGB values to be used in the
  699. execution of a script or macro. 
  700.         
  701. \nw    
  702. Usage - '\{ \tc 15 askrgb\} ' 
  703.     
  704. \{ \ts bu Sample Script\} :
  705.     
  706. options results;
  707. '\{ \tc 15 askrgb\} ';
  708. colors = result;
  709. parse var colors red','grn','blu;
  710. options;
  711.   
  712. See also: \{ \ts b \link "askboolean" "askboolean"
  713.           \link "asknumber " "asknumber"    
  714.           \link "askprop   " "askprop"
  715.           \link "askstring " "askstring"   
  716.           \link "askyn     " "askyn"\}
  717.  
  718. \endnode
  719.  
  720. \node "askstring"
  721. \title "Ask String"
  722. \next "askyn"
  723. \prev "askrgb"
  724. \{ \tc 15 Askstring \} - Asks the user for a text string.
  725.  
  726. \nw    
  727. Usage - '\{ \tc 15 askstring <prompt> <preset>\} '
  728.     
  729. \{ \ts bu Sample Script\} :
  730.     
  731. options results;
  732. '\{ \ts 15 askstring "Buffername:" "clip"\} 'newname;
  733. newname = result;
  734. options;
  735.     
  736. See also: \{ \ts b \link "askboolean" "askboolean"
  737.           \link "asknumber " "asknumber"
  738.           \link "askprop   " "askprop" 
  739.           \link "askrgb    " "askrgb"
  740.           \link "askyn     " "askyn"\}
  741.  
  742. \endnode
  743.  
  744. \node "askyn"
  745. \title "Ask Yes No"
  746. \next "aspect"
  747. \prev "askstring"
  748. \{ \tc 15 Askyn \} - Prompts user to select one of two gadgets. 
  749.  
  750. A two button panel returning a 0 for the left most gadget and a 1 for the
  751. right most gadget.
  752.  
  753. \nw    
  754. Usage - '\{ \tc 15 askyn <notext> <yestext>\} '
  755.     
  756. \{ \ts bu Sample Script\} :
  757.       
  758. options results;
  759. '\{ \tc 15 askyn Yes No\} ';
  760. flag = result;
  761. options;
  762.         
  763. See also: \{ \ts b \link "askboolean" "askboolean"
  764.           \link "asknumber " "asknumber"
  765.           \link "askprop   " "askprop"
  766.           \link "askrgb    " "askrgb"
  767.           \link "askstring " "askstring"\}
  768.           
  769. \endnode
  770.  
  771. \node "aspect"
  772. \title "Aspect"
  773. \next ""
  774. \prev "askyn"
  775. \{ \tc 15 setaspect \} - Allows the change of aspect ratio on any buffer.
  776.  
  777. \nw    
  778. Usage - '\{ \tc 15 setaspect <Buffer> <X> <Y>\} '
  779.     
  780. \{ \ts bu Sample Script\} :
  781.     
  782. options results;
  783. 'asknumber Xwide: 127'; 
  784. Xwide = result;
  785. 'asknumber Ywide: 127'; 
  786. Ywide = result;
  787. options;
  788. '\{ \tc 15 setaspect 0\} 'xwide ywide;
  789.     
  790. * User Interface: \{ \tc 15   Buffer Panel
  791.                         Set Current Aspect Ratio\}
  792.        
  793. \endnode
  794.  
  795.